home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3x / curs_getwstr.z / curs_getwstr
Encoding:
Text File  |  1998-10-20  |  6.3 KB  |  63 lines

  1.  
  2.  
  3.  
  4. ccccuuuurrrrssss____ggggeeeettttwwwwssssttttrrrr((((3333XXXX))))                                              ccccuuuurrrrssss____ggggeeeettttwwwwssssttttrrrr((((3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _cccc_uuuu_rrrr_ssss______gggg_eeee_tttt_wwww_ssss_tttt_rrrr: _gggg_eeee_tttt_wwww_ssss_tttt_rrrr, _gggg_eeee_tttt_nnnn_wwww_ssss_tttt_rrrr, _wwww_gggg_eeee_tttt_wwww_ssss_tttt_rrrr, _wwww_gggg_eeee_tttt_nnnn_wwww_ssss_tttt_rrrr, _mmmm_vvvv_gggg_eeee_tttt_wwww_ssss_tttt_rrrr,
  10.      _mmmm_vvvv_gggg_eeee_tttt_nnnn_wwww_ssss_tttt_rrrr, _mmmm_vvvv_wwww_gggg_eeee_tttt_wwww_ssss_tttt_rrrr, _mmmm_vvvv_wwww_gggg_eeee_tttt_nnnn_wwww_ssss_tttt_rrrr - get _wwww_cccc_hhhh_aaaa_rrrr______tttt character strings from
  11.      _cccc_uuuu_rrrr_ssss_eeee_ssss terminal keyboard
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_cccc_uuuu_rrrr_ssss_eeee_ssss_...._hhhh_>>>>
  15.  
  16.      _iiii_nnnn_tttt _gggg_eeee_tttt_wwww_ssss_tttt_rrrr_((((_wwww_cccc_hhhh_aaaa_rrrr______tttt _****_wwww_ssss_tttt_rrrr_))))_;;;;
  17.      _iiii_nnnn_tttt _gggg_eeee_tttt_nnnn_wwww_ssss_tttt_rrrr_((((_wwww_cccc_hhhh_aaaa_rrrr______tttt _****_wwww_ssss_tttt_rrrr_,,,, _iiii_nnnn_tttt _nnnn_))))_;;;;
  18.      _iiii_nnnn_tttt _wwww_gggg_eeee_tttt_wwww_ssss_tttt_rrrr_((((_WWWW_IIII_NNNN_DDDD_OOOO_WWWW _****_wwww_iiii_nnnn_,,,, _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_wwww_ssss_tttt_rrrr_))))_;;;;
  19.      _iiii_nnnn_tttt _wwww_gggg_eeee_tttt_nnnn_wwww_ssss_tttt_rrrr_((((_WWWW_IIII_NNNN_DDDD_OOOO_WWWW _****_wwww_iiii_nnnn_,,,, _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_wwww_ssss_tttt_rrrr_,,,, _iiii_nnnn_tttt _nnnn_))))_;;;;
  20.      _iiii_nnnn_tttt _mmmm_vvvv_gggg_eeee_tttt_wwww_ssss_tttt_rrrr_((((_iiii_nnnn_tttt _yyyy_,,,, _iiii_nnnn_tttt _xxxx_,,,, _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_wwww_ssss_tttt_rrrr_))))_;;;;
  21.      _iiii_nnnn_tttt _mmmm_vvvv_gggg_eeee_tttt_nnnn_wwww_ssss_tttt_rrrr_((((_iiii_nnnn_tttt _yyyy_,,,, _iiii_nnnn_tttt _xxxx_,,,, _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_wwww_ssss_tttt_rrrr_,,,, _iiii_nnnn_tttt _nnnn_))))_;;;;
  22.      _iiii_nnnn_tttt _mmmm_vvvv_wwww_gggg_eeee_tttt_wwww_ssss_tttt_rrrr_((((_WWWW_IIII_NNNN_DDDD_OOOO_WWWW _****_wwww_iiii_nnnn_,,,, _iiii_nnnn_tttt _yyyy_,,,, _iiii_nnnn_tttt _xxxx_,,,, _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_wwww_ssss_tttt_rrrr_))))_;;;;
  23.      _iiii_nnnn_tttt _mmmm_vvvv_wwww_gggg_eeee_tttt_nnnn_wwww_ssss_tttt_rrrr_((((_WWWW_IIII_NNNN_DDDD_OOOO_WWWW _****_wwww_iiii_nnnn_,,,, _iiii_nnnn_tttt _yyyy_,,,, _iiii_nnnn_tttt _xxxx_,,,, _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_wwww_ssss_tttt_rrrr_,,,, _iiii_nnnn_tttt _nnnn_))))_;;;;
  24.  
  25. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  26.      The effect of _gggg_eeee_tttt_wwww_ssss_tttt_rrrr is as though a series of calls to _gggg_eeee_tttt_wwww_cccc_hhhh were made,
  27.      until a newline and carriage return is received.  The resulting value is
  28.      placed in the area pointed to by the _wwww_cccc_hhhh_aaaa_rrrr______tttt pointer _s_t_r.  _gggg_eeee_tttt_nnnn_wwww_ssss_tttt_rrrr reads
  29.      at most _n _wwww_cccc_hhhh_aaaa_rrrr______tttt characters, thus preventing a possible overflow of the
  30.      input buffer.  The user's erase and kill characters are interpreted, as
  31.      well as any special keys (such as function keys, ``home'' key, ``clear''
  32.      key, etc.).
  33.  
  34. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  35.      All routines return the integer _EEEE_RRRR_RRRR upon failure and an integer value
  36.      other than _EEEE_RRRR_RRRR upon successful completion.
  37.  
  38. NNNNOOOOTTTTEEEESSSS
  39.      The header file _<<<<_cccc_uuuu_rrrr_ssss_eeee_ssss_...._hhhh_>>>> automatically includes the header files
  40.      _<<<<_ssss_tttt_dddd_iiii_oooo_...._hhhh_>>>> and _<<<<_uuuu_nnnn_cccc_tttt_rrrr_llll_...._hhhh_>>>>.
  41.  
  42.      Note that all routines except _wwww_gggg_eeee_tttt_nnnn_wwww_ssss_tttt_rrrr may be macros.
  43.  
  44. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  45.      _cccc_uuuu_rrrr_ssss_eeee_ssss(3X), _cccc_uuuu_rrrr_ssss______gggg_eeee_tttt_wwww_cccc_hhhh(3X).
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                                                         PPPPaaaaggggeeee 1111
  59.  
  60.  
  61.  
  62.